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Lighting a Fire Under Authorware Graphics 


re you sure you are getting the 


Authorware? Maybe not. This 
article will delve into techniques to make 
certain the graphics in your applications 
are not dragging down performance. 
Before we get down to manipulating 
icons, we should talk about how to pre- 
pare graphics for use in Authorware. 
The rule-of-thumb is, never use more 
bits-per-pixel than are necessary. For in- 
stance, if your graphic only has 16 
unique colors, make it a four bit (16 
color) bitmap, not an eight bit (256 
color) image. Note that you can pick any 
sixteen colors that are in your palette. 
You don’t have to confine yourself to the 
dreaded VGA Sixteen. If you are run- 
ning on an eight bit system, don’t use 16 
or 24 bit images. They are painfully 
slow. Dither them down using Photo- 
Shop or an equivalent graphics package. 
An aside about graphics with solid col- 


last bit of performance out of 


ors: Don’t dither these. Remap the col- 
ors to an eight or 16 bit palette. If you 
dither them, it will introduce random 
patterns which will spoil their solid pu- 
rity and it will also inhibit compression. 

The fewer bits you use, the better. 
The chart in figure | indicates the dra- 
matic savings in size, which can trans- 
late into savings in time. 

Remember that monochrome (1 bit) 
bitmaps may be colorized in Author- 
ware. That means you can change the 
black bits to any color you choose, while 
retaining the size and speed advantages 
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Figure 1. 


Beginner’s Corner: The Sound of Silence? 


owdy, and welcome to this 
month’s Beginner’s Corner! 
Even you advanced users may 
want to peek over here while no one’s 
looking, because this little feature can 
nail the best of us. In fact, this little 


feature did nail this faithful author one 
recent evening, thus prompting the 
article you now hold in your capable, yet 

gentle hands. 
The problem was that a sound which 
(Continued on page 3) 


of monochrome. 

If you have to distort a bitmap by 
stretching or shrinking it, don’t do it in 
Authorware. Authorware has to “re- 
stretch” it each time the program runs. 
Instead, stretch or shrink the graphic in 
a paint program, and then copy it into 
Authorware. 

After you have properly prepared 
your graphic, you can import it into Au- 
thorware. The first thing you should de- 
cide is what graphics mode you will use 
to display the bitmap. Under Windows, 
try to use opaque mode whenever you 
can. It is the fastest mode. The other 
modes are slower. Matted and transpar- 
ent are not only slower, but they also re- 
quire more space. 

On the Macintosh, the modes are a 
bit different. The following chart indi- 
cates the correspondence between 
modes on the different platforms: 


APW APM 
Opaque 

Matted Opaque 
Transparent Transparent 
Inverse Inverse 
Erase Erase 


Note that Opaque on the Mac corre- 
sponds to Matted under Windows. This 
means that when you port your Mac 
apps to Windows, they will run more 
slowly. You can improve performance 
by changing the mode from Matted to 
Opaque. Instead of changing each and 
every one after you port, you may want 
to just change the larger ones, which will 
have a more dramatic effect on perfor- 
mance. 


(Continued on page 3) 
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n the last issue, we tackled the 
nettlesome font problems that 
plague cross-platform 
development. In this issue, we will 
cover some of the issues that face writers 
of DLL’s and XCMD’s. This article 
assumes that you, the reader, know what 
XCMD’s and DLL’s are. In fact, we are 
not even going to explain what the 
acronyms stand for. 

First, let us describe some of the 
differences between DLL’s and 
XCMD’s. For starters, XCMD’s can be 
likened to parasites. They eke out a 
lowly existence, completely dependent 
on their host organism (in this case 
Authorware). They can be difficult to 
write and sometimes horribly painful to 
debug. On the other hand, DLL’s are a 
delight to developers everywhere. They 
are like small stand-alone programs, 
with their own life, loves, and three- 
chambered hearts. They can carry on a 
very intelligent and fruitful conversation 
with Authorware and can _ perform 
amazing feats. 

But this article is about cross- 
platform XCMD and DLL development, 
so we will confine ourselves to the 
lowest common denominators between 
the two. 

The most important thing to keep in 
mind when designing cross-platform 
external functions is parameter 
harmonization. The goal is to remove 
human intervention from the platform 
conversion process, because fiddling 
with parameters to functions is a big 
headache during conversion. 


Figure 1. An XCMD. 


Harmonization starts with fixing the 
number of parameters the function will 
receive. XCMD’s can receive a variable 
number of parameters. This is useful for 
Mac-only external functions. DLL’s, on 
the other hand, have a fixed number of 
parameters. This means that the number 
of parameters on both platforms should 


be constant. 

Also be aware that XCMD’s can only 
accommodate sixteen _— parameters. 
DLL’s can accept more than that. 
Cross-platform functions should have 
sixteen or fewer parameters. 

Also realize that DLL’s usually 
require one extra parameter that 
XCMD’s don’t. It is the system variable 
WindowHandle. WindowHandle holds 
the handle of the Authorware 
presentation window (in APW only). 
DLL’s usually need this for expression 
evaluation, posting displays, and 
Windows API functions that require a 
window handle. Always include a 
dummy parameter in the XCMD for 
WindowHandle. The XCMD can ignore 


Figure 2. A DLL (adult male). 


whatever is passed. 

One small problem is that there is no 

WindowHandle variable in APM. To 
avoid having to change this parameter 
by hand during conversion, pass the 
following expression in the 
WindowHandle parameter: 
if(OSNumber=3, 
Eval(“WindowHandle’”), 0) 
If the program is running under the 
Macintosh, zero will be passed. Under 
Windows, APW will evaluate the string 
and pass the contents of the 
WindowHandle variable. 

Usually, external functions come in 
groups. For instance, a group of 
functions that manipulate a scrolling list 
box might have one function to create 
the list, one to destroy it, and one to 
return the current selection in the list. A 
single DLL can have any number of 
exported functions. This is very handy 
to nicely package a group of related 


Iventures Across the Great Divide 


functions. | Unfortunately, XCMD’s 
have one function. This means that 
there are two approaches to grouping 
functions. You can create an XCMD for 
each function that is required. This can 
present another set of headaches for the 
developer, but it is the preferred way. 
Another technique is to use a single 
function that behaves differently 
depending on a “selector” value that 
Authorware passes to it. The parameters 
in the function have different meanings 
depending on which “selector” is passed 
in. For instance, in the list box example 
described before, the number | might 
mean create, the number 2 destroy, etc. 
Some parameters may be_ ignored, 
depending on the selector. This keeps 
all the XCMD code in one function but 
it is much more confusing for the author. 
A final precaution for cross-platform 
external function developers: be careful 
about taking advantage of features on 
one platform that might be more difficult 
to implement on the other. An example 
is having the external function draw on 
the presentation window. This works 
very well under Windows, as APW 
supports DLL’s posting display objects. 
Under the Mac, however, it might be 
harder. You can draw directly to the 
presentation window on the Mac, but 
Authorware is not cognizant of what the 
XCMD has done and will blindly erase 
the_external function’s work. A better 
solution might be to create a Quickdraw 
picture and post it instead. How is this 
done, you ask? We have to save some 
material for future issues, you know. 
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(Continued from page 1) 

should have played, did not. The sound, 
set to concurrent operation, was to play 
at the conclusion of a normal interaction, 
and was part of the feedback path 
leading out of the interaction. The 
puzzling thing was that telling the sound 
to wait until done, instead of playing 


It It 
(2) Gl 
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Remember that every path to the right 
of an interaction icon has independent 
feedback erasing controls. The sound 
icon “AllCorrectMatched-- to boisterous 
applause”, is in fact feedback for path 4 
(numbered left to right), and will then be 
controlled by the feedback erasing 
options in the response options dialogue 


Choose all three items +Part 1 
inn +Part 2 
it +Part 3 


AllCorrectM atched-- to boisterous applause 


Figure 1. 


concurrently, enabled the sound to play. 
The interaction is shown in figure 1. 

You may recall that a sound (or 
animation, or movie) icon set to 
concurrent merely means that the sound 
will begin playing, and the next icon in 
the flow line will be executed (that does 
sound harsh) before the sound is 
completed. In other words, concurrent 
means “get me started, and immediately 
move on down the flowline”. Most 
events in Authorware, of course, are 
“Wait Until Done”, which means “don’t 
do nothing ‘til you hear from me”. 

So why would the sound not play 
when set to concurrent? The answer lies 
not so much in the sound icon’s 
concurrency, or lack thereof, but in 
Authorware’s powerful automatic 
erasing features. In a sense, we asked 
Authorware to erase the sound, because 
of the setting in the options dialog. 


Match If TRUE: 


Auto-match 


Conditional Options 


(Figure 2). 

In effect, the erase feedback option, 
which happens to be set to Erase 
Feedback - On Exit, is_ telling 
Authorware to erase the sound as soon 
as the flow exits the interaction. Erase 
the sound? Yes, “erase” the sound. 
Authorware erases a sound’ by 
terminating it. Because the sound was 
set to concurrent, the sound was hardly 
started before the interaction was exited. 
Authorware “erased” the sound before it 
had a chance to play, since the exit is 
immediate. 

There is more than one solution to the 
problem. You could either set the sound 
to “Wait Until Done,” or you could 
change the Erase Feedback Options. 
You have to decide which works best in 
your application. 


im Perpetual 


Not Judged 
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Figure 2. 


Lighting A Fire... 
(Continued from page 1) 

Now that we have properly prepared 
the graphics, we can begin introducing 
techniques to make them display even 
faster. APW’s Preload system function 
offers one way to do this. Preloading 
under APW does two things. It first 
loads the graphic into memory at the 
time of the call to the function. Second, 
it internally converts the graphic into a 
more optimal format for display on the 
screen. You must keep in mind 
Preload’s limitations, however. APW 
will keep only 40 bitmaps in the optimal 
format. If you preload a graphic too far 
in advance, APW might purge it before 
you reach the point where it is to appear 
on the screen. Low memory conditions 
also constrain the use of Preload. Figure 
2 (on page 4) shows an example of using 
Preload. 

The next technique has to do with 
layering display icons. Usually, layering 
is used to indicate which graphics ap- 
pear “on top” and which appear 
“below.” Layering can also be used to 
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Incendiary Graphics 


(Continued from page 3) 

improve performance. Assigning a layer 
of greater than one does a couple of 
things. First, it converts the graphic into 
the optimal display format, just like 
Preload does. Second, it draws the 


Preload{lconID @"Big Graphic") 


Figure 2. 


graphic in the Authorware animation 
buffer. To understand why this helpful, 
you need to know a little bit about how 
Authorware draws graphics. Any dis- 
plays at layer 0 or less are drawn to the 
background buffer. By default, display 
icons are at layer zero. Authorware 
keeps the graphics in this area separate 


from the ones in the animation buffer. 
This means that when a graphic in the 
animation buffer changes (by being 
erased or moved), the background buffer 
does not have to change. On the other 
hand, if a graphic in the background 
buffer changes, 
the background 
has to be redrawn. 

How does this 


help perfor- 
mance? If you 
have a_ large 


bitmap in the 

“ground, and 
A smaller 
graphics to greater 
than zero, Author- 
ware will be able to draw and erase the 
smaller graphics without tampering with 
the background. The drawing and eras- 
ing will be faster. 

Do not be tempted to put everything 
you can in layers greater than zero. This 
technique works in part by keeping a dis- 
tinction between backeroyngeapiics, 
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which are relatively static, and fore- 
ground graphics (layered or animated 
graphics) that change more often. Also, 
as the number and size of the graphics in 
the animation buffer (layers greater than 
zero) increase, performance will eventu- 
ally taper off and become worse and 
worse. 

There is another factor to consider 
when improving graphic performance. 
The “Update Displayed Variables” op- 
tion in the effects dialog can slow down 
the displays. An alternative is to embed 
the variable, and use the DisplayIcon 
function to-update the variable-when it 
changes. This is a little more compli- 
cated, because you must be aware of 
when the variable changes, rather than 
letting Authorware do it for you. 

The final technique for tuning your 
application for performance is experi- 
mentation. Your situation is unique, and 
sometimes trial and error is the only way 
to figure out what works best in your cir- 
cumstances. 


: Old Glory 


USA 


For US. addresses only 


